LL CORDIC Functions

CORDIC Configuration functions

STM32C562xx STM32C5A3xx STM32C542xx

group CORDIC_LL_EF_Configuration

Functions

void LL_CORDIC_Config ( CORDIC_TypeDef * p_cordic , uint32_t function , uint32_t precision , uint32_t scale , uint32_t number_write , uint32_t number_read , uint32_t input_size , uint32_t output_size )

Configure the CORDIC processing.

Reference Manual to LL API cross reference (Register Field Functions)

CSR FUNC LL_CORDIC_Config

CSR PRECISION LL_CORDIC_Config

CSR SCALE LL_CORDIC_Config

CSR NARGS LL_CORDIC_Config

CSR NRES LL_CORDIC_Config

CSR ARGSIZE LL_CORDIC_Config

CSR RESIZE LL_CORDIC_Config

Note

This function set all parameters of CORDIC processing. These parameters can also be set individually using dedicated functions:

• LL_CORDIC_SetFunction()

• LL_CORDIC_SetPrecision()

• LL_CORDIC_SetScale()

• LL_CORDIC_SetNbWrite()

• LL_CORDIC_SetNbRead()

• LL_CORDIC_SetInWidth()

• LL_CORDIC_SetOutWidth()

Parameters :

• p_cordic – CORDIC instance

• function – parameter can be one of the following values:

  • LL_CORDIC_FUNCTION_COSINE

  • LL_CORDIC_FUNCTION_SINE

  • LL_CORDIC_FUNCTION_PHASE

  • LL_CORDIC_FUNCTION_MODULUS

  • LL_CORDIC_FUNCTION_ARCTANGENT

  • LL_CORDIC_FUNCTION_HCOSINE

  • LL_CORDIC_FUNCTION_HSINE

  • LL_CORDIC_FUNCTION_HARCTANGENT

  • LL_CORDIC_FUNCTION_NATURALLOG

  • LL_CORDIC_FUNCTION_SQUAREROOT

• precision – parameter can be one of the following values:

  • LL_CORDIC_PRECISION_1_CYCLE

  • LL_CORDIC_PRECISION_2_CYCLE

  • LL_CORDIC_PRECISION_3_CYCLE

  • LL_CORDIC_PRECISION_4_CYCLE

  • LL_CORDIC_PRECISION_5_CYCLE

  • LL_CORDIC_PRECISION_6_CYCLE

  • LL_CORDIC_PRECISION_7_CYCLE

  • LL_CORDIC_PRECISION_8_CYCLE

  • LL_CORDIC_PRECISION_9_CYCLE

  • LL_CORDIC_PRECISION_10_CYCLE

  • LL_CORDIC_PRECISION_11_CYCLE

  • LL_CORDIC_PRECISION_12_CYCLE

  • LL_CORDIC_PRECISION_13_CYCLE

  • LL_CORDIC_PRECISION_14_CYCLE

  • LL_CORDIC_PRECISION_15_CYCLE

• scale – parameter can be one of the following values:

  • LL_CORDIC_SCALING_FACTOR_0

  • LL_CORDIC_SCALING_FACTOR_1

  • LL_CORDIC_SCALING_FACTOR_2

  • LL_CORDIC_SCALING_FACTOR_3

  • LL_CORDIC_SCALING_FACTOR_4

  • LL_CORDIC_SCALING_FACTOR_5

  • LL_CORDIC_SCALING_FACTOR_6

  • LL_CORDIC_SCALING_FACTOR_7

• number_write – parameter can be one of the following values:

  • LL_CORDIC_NBWRITE_1

  • LL_CORDIC_NBWRITE_2

• number_read – parameter can be one of the following values:

  • LL_CORDIC_NBREAD_1

  • LL_CORDIC_NBREAD_2

• input_size – parameter can be one of the following values:

  • LL_CORDIC_INWIDTH_32_BIT

  • LL_CORDIC_INWIDTH_16_BIT

• output_size – parameter can be one of the following values:

  • LL_CORDIC_OUTWIDTH_32_BIT

  • LL_CORDIC_OUTWIDTH_16_BIT

void LL_CORDIC_SetFunction ( CORDIC_TypeDef * p_cordic , uint32_t function )

Configure the function.

Reference Manual to LL API cross reference (Register Field Functions)

CSR FUNC LL_CORDIC_SetFunction

Parameters :

• p_cordic – CORDIC Instance

• function – parameter can be one of the following values:

  • LL_CORDIC_FUNCTION_COSINE

  • LL_CORDIC_FUNCTION_SINE

  • LL_CORDIC_FUNCTION_PHASE

  • LL_CORDIC_FUNCTION_MODULUS

  • LL_CORDIC_FUNCTION_ARCTANGENT

  • LL_CORDIC_FUNCTION_HCOSINE

  • LL_CORDIC_FUNCTION_HSINE

  • LL_CORDIC_FUNCTION_HARCTANGENT

  • LL_CORDIC_FUNCTION_NATURALLOG

  • LL_CORDIC_FUNCTION_SQUAREROOT

uint32_t LL_CORDIC_GetFunction ( const CORDIC_TypeDef * p_cordic )

Return the function.

Reference Manual to LL API cross reference (Register Field Functions)

CSR FUNC LL_CORDIC_GetFunction

Parameters :

p_cordic – CORDIC Instance

Return values :

Returned – value can be one of the following values:

• LL_CORDIC_FUNCTION_COSINE

• LL_CORDIC_FUNCTION_SINE

• LL_CORDIC_FUNCTION_PHASE

• LL_CORDIC_FUNCTION_MODULUS

• LL_CORDIC_FUNCTION_ARCTANGENT

• LL_CORDIC_FUNCTION_HCOSINE

• LL_CORDIC_FUNCTION_HSINE

• LL_CORDIC_FUNCTION_HARCTANGENT

• LL_CORDIC_FUNCTION_NATURALLOG

• LL_CORDIC_FUNCTION_SQUAREROOT

void LL_CORDIC_SetPrecision ( CORDIC_TypeDef * p_cordic , uint32_t precision )

Configure precision in cycles number.

Reference Manual to LL API cross reference (Register Field Functions)

CSR PRECISION LL_CORDIC_SetPrecision

Parameters :

• p_cordic – CORDIC Instance

• precision – parameter can be one of the following values:

  • LL_CORDIC_PRECISION_1_CYCLE

  • LL_CORDIC_PRECISION_2_CYCLE

  • LL_CORDIC_PRECISION_3_CYCLE

  • LL_CORDIC_PRECISION_4_CYCLE

  • LL_CORDIC_PRECISION_5_CYCLE

  • LL_CORDIC_PRECISION_6_CYCLE

  • LL_CORDIC_PRECISION_7_CYCLE

  • LL_CORDIC_PRECISION_8_CYCLE

  • LL_CORDIC_PRECISION_9_CYCLE

  • LL_CORDIC_PRECISION_10_CYCLE

  • LL_CORDIC_PRECISION_11_CYCLE

  • LL_CORDIC_PRECISION_12_CYCLE

  • LL_CORDIC_PRECISION_13_CYCLE

  • LL_CORDIC_PRECISION_14_CYCLE

  • LL_CORDIC_PRECISION_15_CYCLE

uint32_t LL_CORDIC_GetPrecision ( const CORDIC_TypeDef * p_cordic )

Return the precision in cycle count.

Reference Manual to LL API cross reference (Register Field Functions)

CSR PRECISION LL_CORDIC_GetPrecision

Parameters :

p_cordic – CORDIC Instance

Return values :

Returned – value can be one of the following values:

• LL_CORDIC_PRECISION_1_CYCLE

• LL_CORDIC_PRECISION_2_CYCLE

• LL_CORDIC_PRECISION_3_CYCLE

• LL_CORDIC_PRECISION_4_CYCLE

• LL_CORDIC_PRECISION_5_CYCLE

• LL_CORDIC_PRECISION_6_CYCLE

• LL_CORDIC_PRECISION_7_CYCLE

• LL_CORDIC_PRECISION_8_CYCLE

• LL_CORDIC_PRECISION_9_CYCLE

• LL_CORDIC_PRECISION_10_CYCLE

• LL_CORDIC_PRECISION_11_CYCLE

• LL_CORDIC_PRECISION_12_CYCLE

• LL_CORDIC_PRECISION_13_CYCLE

• LL_CORDIC_PRECISION_14_CYCLE

• LL_CORDIC_PRECISION_15_CYCLE

void LL_CORDIC_SetScale ( CORDIC_TypeDef * p_cordic , uint32_t scale )

Configure scaling factor.

Reference Manual to LL API cross reference (Register Field Functions)

CSR SCALE LL_CORDIC_SetScale

Parameters :

• p_cordic – CORDIC Instance

• scale – parameter can be one of the following values:

  • LL_CORDIC_SCALING_FACTOR_0

  • LL_CORDIC_SCALING_FACTOR_1

  • LL_CORDIC_SCALING_FACTOR_2

  • LL_CORDIC_SCALING_FACTOR_3

  • LL_CORDIC_SCALING_FACTOR_4

  • LL_CORDIC_SCALING_FACTOR_5

  • LL_CORDIC_SCALING_FACTOR_6

  • LL_CORDIC_SCALING_FACTOR_7

uint32_t LL_CORDIC_GetScale ( const CORDIC_TypeDef * p_cordic )

Return the scaling factor.

Reference Manual to LL API cross reference (Register Field Functions)

CSR SCALE LL_CORDIC_GetScale

Parameters :

p_cordic – CORDIC Instance

Return values :

Returned – value can be one of the following values:

• LL_CORDIC_SCALING_FACTOR_0

• LL_CORDIC_SCALING_FACTOR_1

• LL_CORDIC_SCALING_FACTOR_2

• LL_CORDIC_SCALING_FACTOR_3

• LL_CORDIC_SCALING_FACTOR_4

• LL_CORDIC_SCALING_FACTOR_5

• LL_CORDIC_SCALING_FACTOR_6

• LL_CORDIC_SCALING_FACTOR_7

void LL_CORDIC_SetNbWrite ( CORDIC_TypeDef * p_cordic , uint32_t number_write )

Configure number of 32-bit write expected for one calculation.

Reference Manual to LL API cross reference (Register Field Functions)

CSR NARGS LL_CORDIC_SetNbWrite

Parameters :

• p_cordic – CORDIC Instance

• number_write – parameter can be one of the following values:

  • LL_CORDIC_NBWRITE_1

  • LL_CORDIC_NBWRITE_2

uint32_t LL_CORDIC_GetNbWrite ( const CORDIC_TypeDef * p_cordic )

Return the number of 32-bit writes expected for one calculation.

Reference Manual to LL API cross reference (Register Field Functions)

CSR NARGS LL_CORDIC_GetNbWrite

Parameters :

p_cordic – CORDIC Instance

Return values :

Returned – value can be one of the following values:

• LL_CORDIC_NBWRITE_1

• LL_CORDIC_NBWRITE_2

void LL_CORDIC_SetNbRead ( CORDIC_TypeDef * p_cordic , uint32_t number_read )

Configure number of 32-bit read expected after one calculation.

Reference Manual to LL API cross reference (Register Field Functions)

CSR NRES LL_CORDIC_SetNbRead

Parameters :

• p_cordic – CORDIC Instance

• number_read – parameter can be one of the following values:

  • LL_CORDIC_NBREAD_1

  • LL_CORDIC_NBREAD_2

uint32_t LL_CORDIC_GetNbRead ( const CORDIC_TypeDef * p_cordic )

Return the number of 32-bit reads expected after one calculation.

Reference Manual to LL API cross reference (Register Field Functions)

CSR NRES LL_CORDIC_GetNbRead

Parameters :

p_cordic – CORDIC Instance

Return values :

Returned – value can be one of the following values:

• LL_CORDIC_NBREAD_1

• LL_CORDIC_NBREAD_2

void LL_CORDIC_SetInWidth ( CORDIC_TypeDef * p_cordic , uint32_t input_size )

Configure width of input data.

Reference Manual to LL API cross reference (Register Field Functions)

CSR ARGSIZE LL_CORDIC_SetInWidth

Parameters :

• p_cordic – CORDIC Instance

• input_size – parameter can be one of the following values:

  • LL_CORDIC_INWIDTH_32_BIT

  • LL_CORDIC_INWIDTH_16_BIT

uint32_t LL_CORDIC_GetInWidth ( const CORDIC_TypeDef * p_cordic )

Return the width of input data.

Reference Manual to LL API cross reference (Register Field Functions)

CSR ARGSIZE LL_CORDIC_GetInWidth

Parameters :

p_cordic – CORDIC Instance

Return values :

Returned – value can be one of the following values:

• LL_CORDIC_INWIDTH_32_BIT

• LL_CORDIC_INWIDTH_16_BIT

void LL_CORDIC_SetOutWidth ( CORDIC_TypeDef * p_cordic , uint32_t output_size )

Configure width of output data.

Reference Manual to LL API cross reference (Register Field Functions)

CSR RESIZE LL_CORDIC_SetOutWidth

Parameters :

• p_cordic – CORDIC Instance

• output_size – parameter can be one of the following values:

  • LL_CORDIC_OUTWIDTH_32_BIT

  • LL_CORDIC_OUTWIDTH_16_BIT

uint32_t LL_CORDIC_GetOutWidth ( const CORDIC_TypeDef * p_cordic )

Return the width of output data.

Reference Manual to LL API cross reference (Register Field Functions)

CSR RESIZE LL_CORDIC_GetOutWidth

Parameters :

p_cordic – CORDIC Instance

Return values :

Returned – value can be one of the following values:

• LL_CORDIC_OUTWIDTH_32_BIT

• LL_CORDIC_OUTWIDTH_16_BIT

IT_Management

STM32C562xx STM32C5A3xx STM32C542xx

group CORDIC_LL_EF_IT_Management

Functions

void LL_CORDIC_EnableIT ( CORDIC_TypeDef * p_cordic )

Enable the CORDIC interrupt when result is ready.

Reference Manual to LL API cross reference (Register Field Functions)

CSR IEN LL_CORDIC_EnableIT

Parameters :

p_cordic – pointer to CORDIC handle.

void LL_CORDIC_DisableIT ( CORDIC_TypeDef * p_cordic )

Disable the CORDIC interrupt.

Reference Manual to LL API cross reference (Register Field Functions)

CSR IEN LL_CORDIC_DisableIT

Parameters :

p_cordic – pointer to CORDIC handle.

uint32_t LL_CORDIC_IsActiveFlag ( const CORDIC_TypeDef * p_cordic , uint32_t mask )

Check whether the specified CORDIC status flag is set or not.

Parameters :

• p_cordic – pointer to CORDIC handle.

• mask – CORDIC flag to check This parameter can be one of the following values:

  • CORDIC_FLAG_RRDY Result Ready Flag

Return values :

1UL – (flag is set) or 0UL (flag is reset)

uint32_t LL_CORDIC_IsEnabledIT ( const CORDIC_TypeDef * p_cordic )

Check whether the specified CORDIC interrupt is enabled.

Reference Manual to LL API cross reference (Register Field Functions)

CSR IEN LL_CORDIC_IsEnabledIT

Parameters :

p_cordic – pointer to CORDIC handle.

Return values :

1UL – (flag is set) or 0UL (flag is reset)

uint32_t LL_CORDIC_GetITSource ( const CORDIC_TypeDef * p_cordic , uint32_t interrupt )

Check whether the specified CORDIC interrupt is enabled or not.

Parameters :

• p_cordic – CORDIC instance.

• interrupt – CORDIC interrupt to check

Return values :

value – of the interrupt in the register

DMA_Management

STM32C562xx STM32C5A3xx STM32C542xx

group CORDIC_LL_EF_DMA_Management

Functions

void LL_CORDIC_EnableDMAReq_RD ( CORDIC_TypeDef * p_cordic )

Enable CORDIC DMA read channel request.

Reference Manual to LL API cross reference (Register Field Functions)

CSR DMAREN LL_CORDIC_EnableDMAReq_RD

Parameters :

p_cordic – CORDIC Instance

void LL_CORDIC_DisableDMAReq_RD ( CORDIC_TypeDef * p_cordic )

Disable CORDIC DMA read channel request.

Reference Manual to LL API cross reference (Register Field Functions)

CSR DMAREN LL_CORDIC_DisableDMAReq_RD

Parameters :

p_cordic – CORDIC Instance

uint32_t LL_CORDIC_IsEnabledDMAReq_RD ( const CORDIC_TypeDef * p_cordic )

Check the CORDIC DMA read channel request state.

Reference Manual to LL API cross reference (Register Field Functions)

CSR DMAREN LL_CORDIC_IsEnabledDMAReq_RD

Parameters :

p_cordic – CORDIC Instance

Return values :

State – of bit (1 or 0).

void LL_CORDIC_EnableDMAReq_WR ( CORDIC_TypeDef * p_cordic )

Enable CORDIC DMA write channel request.

Reference Manual to LL API cross reference (Register Field Functions)

CSR DMAWEN LL_CORDIC_EnableDMAReq_WR

Parameters :

p_cordic – CORDIC Instance

void LL_CORDIC_DisableDMAReq_WR ( CORDIC_TypeDef * p_cordic )

Disable CORDIC DMA write channel request.

Reference Manual to LL API cross reference (Register Field Functions)

CSR DMAWEN LL_CORDIC_DisableDMAReq_WR

Parameters :

p_cordic – CORDIC Instance

uint32_t LL_CORDIC_IsEnabledDMAReq_WR ( const CORDIC_TypeDef * p_cordic )

Check the CORDIC DMA write channel request state.

Reference Manual to LL API cross reference (Register Field Functions)

CSR DMAWEN LL_CORDIC_IsEnabledDMAReq_WR

Parameters :

p_cordic – CORDIC Instance

Return values :

State – of bit (1 or 0).

uint32_t LL_CORDIC_DMA_GetRegAddr ( const CORDIC_TypeDef * p_cordic , uint32_t direction )

Get the CORDIC data register address used for DMA transfer.

Reference Manual to LL API cross reference (Register Field Functions)

RDATA RES LL_CORDIC_DMA_GetRegAddr

WDATA ARG LL_CORDIC_DMA_GetRegAddr

Parameters :

• p_cordic – CORDIC Instance

• direction – parameter can be one of the following values:

  • LL_CORDIC_DMA_REG_DATA_IN

  • LL_CORDIC_DMA_REG_DATA_OUT

Return values :

Address – of data register

FLAG_Management

STM32C562xx STM32C5A3xx STM32C542xx

group CORDIC_LL_EF_FLAG_Management

Functions

uint32_t LL_CORDIC_IsActiveFlag_RRDY ( const CORDIC_TypeDef * p_cordic )

Check CORDIC result ready flag state.

Reference Manual to LL API cross reference (Register Field Functions)

CSR RRDY LL_CORDIC_IsActiveFlag_RRDY

Parameters :

p_cordic – CORDIC Instance

Return values :

State – of bit (1 or 0).

Data_Management

STM32C562xx STM32C5A3xx STM32C542xx

group CORDIC_LL_EF_Data_Management

Functions

void LL_CORDIC_WriteData ( CORDIC_TypeDef * p_cordic , uint32_t input_data )

Write 32-bit input data for the CORDIC processing.

Reference Manual to LL API cross reference (Register Field Functions)

WDATA ARG LL_CORDIC_WriteData

Parameters :

• p_cordic – CORDIC Instance

• input_data – 0 .. 0xFFFFFFFF : 32-bit value to be provided as input data for CORDIC processing.

uint32_t LL_CORDIC_ReadData ( const CORDIC_TypeDef * p_cordic )

Return the 32-bit output data of CORDIC processing.

Reference Manual to LL API cross reference (Register Field Functions)

RDATA RES LL_CORDIC_ReadData

Parameters :

p_cordic – CORDIC Instance

Return values :

32-bit – output data of CORDIC processing.